home *** CD-ROM | disk | FTP | other *** search
/ Ian & Stuart's Australian Mac: Not for Sale / Another.not.for.sale (Australia).iso / hold me in your arms / PGP 2.6 / pgp2.6 Source / doc / readme.vms < prev    next >
Text File  |  1994-05-23  |  7KB  |  154 lines
  1. PGP/VMS Version 2.6
  2. -------------------
  3.  
  4. THIS MAY OR MAY NOT WORK.
  5.  
  6. The pgp26/vmsbuild contains support files for building a VMS
  7. version of PGP 2.6. We at MIT have not tested this code out,
  8. but it should work without too much effort. See the file:
  9. pgp26/vmsbuild/000read.me.
  10.  
  11. In particular, PGP 2.6 needs to be linked with the RSAREF library. David
  12. North has provided a build file "pgp26/vmsbuild/rsabuild.com" that should
  13. help in building RSAREF.
  14.  
  15. If you can figure out how to compile it, it SHOULD work.  One change is
  16. that PGP can now look for support files in a system-wide directory.
  17. The default (PGP_SYSTEM_DIR, defined in fileio.h) is PGP$LIBRARY:, but
  18. you can change that if you like.
  19.  
  20. --- PGP 2.3 instructions follow ---
  21.  
  22. All rights to PGP are reserved by Phil Zimmermann. All contributed
  23. modules are also subject to the copyrights of their individual authors,
  24. on the same conditions. Certain algorithms used by PGP are subject to
  25. patent restrictions and this software as a whole may be subject to
  26. export control in certain countries. Read the PGP Guide for full
  27. copyright information and for details about export control.
  28.  
  29. These notes are intended for those people using and working with PGP under
  30. the VAX/VMS operating system. These are intended to supplement rather than
  31. replace the PGP guide. You should read and understand the guide, particularly
  32. the section about key management.
  33.  
  34. If you unzip under VMS using the public domain Zipper - you will probably have
  35. a problem with file characteristics. If you have the PD FILE utility, you can
  36. fix this by saying:
  37.  
  38. $ FILE/type=stream  *.*
  39.  
  40. Otherwise you can fix using either TPU or CONVERT/FDL.
  41.  
  42. PGP/VMS was written using the VAX C compiler, which you must have to
  43. compile it. If you wish to use another compiler, see the developers notes.
  44. PGP is provided with an MMS description file. To build using this file, go
  45. to the directory containing the uncompressed files and type the following:
  46.  
  47. $ MMS PGP.EXE
  48.  
  49. You may wish to delete the object files at this point, they are not needed
  50. unless you are working on the code. To build a version under the VAX/VMS
  51. debugger, define the DCL symbol PGP_DEBUG=1. The debugger version will be
  52. built without any optimisation and will be *significantly* slower.
  53.  
  54. If you do not have MMS you may execute the DCL supplied command procedure
  55. VMSBUILD.COM to compile and link PGP.
  56.  
  57. Once you have built PGP, it should be placed somewhere that is protected
  58. against tampering. It is not impossible that someone may replace PGP.EXE
  59. with a patched version designed to capture keys. You may wish to use the
  60. CHECKSUM utility (CHECKSUM/IMAGE PGP.EXE) to control against modifications,
  61. however CHECKSUM does not use very effective algorithms and may itself be
  62. compromised.
  63.  
  64. You should then use PGP by defining it as an "external command" in your
  65. LOGIN.COM, or alternative the system wide login command procedure, SYLOGIN.
  66. This is done simply with the following line of DCL:
  67.  
  68. $ PGP:==$device:[directory]PGP
  69.  
  70. After executing this line (remember the dollar sign before the device name),
  71. you should be able to display a help text by typing:
  72.  
  73. $ PGP
  74.  
  75. PGP will want to retain the keyrings and some other information. These are
  76. stored in the device and directory pointed to by the logical name PGPPATH.
  77. You should copy the files LANGUAGE.TXT and CONFIG.TXT to this directory.
  78.  
  79. Your secret keyring contains information that could be cryptographically
  80. analysed - it must be protected against world access. However, your secret key
  81. ring is encrypted so is protected against casual browsing. If anyone that you
  82. can not trust has privileged access to your system, your plaintext files are
  83. vulnerable and potentially, also your keyrings.
  84.  
  85. Note that keyrings should be directly transportable between VMS, MSDOS
  86. and other PGP implementations. Text files may not be portable because of the
  87. different text record representations across operating systems. If you wish
  88. to send a text file to a system other than VAX/VMS, you are recommended to
  89. use the 'canonical-form' switch '-t'.
  90.  
  91. If you wish to take binary files such as backup savesets between two systems
  92. running VMS, you can use the special flag 'i' with the encrypt function to
  93. preserve the file and record characteristics. When decrypting, PGP will read
  94. the 'i' flag and the type of the system that created the file. If both systems
  95. are VMS, the file will be correctly decrypted with the correct file
  96. characteristics.
  97.  
  98. Special Notes For V2.2 And Following
  99. ------------------------------------
  100.  
  101. This version improves the keyboard handling. Specifically, it addresses
  102. the CPU bound loop whilst reading terminal input and provides better prompt
  103. and keyboard handling.
  104.  
  105. Developers Notes
  106. ----------------
  107.  
  108. There are two key conditionals throughout the source for the VAX/VMS
  109. implementation:
  110.  
  111. VAXC -  Allows specific optimisations permitted by the VAX C compiler and
  112.         overcomes problems with the differences between VAX C and ANSI C.
  113.  
  114. VMS  -  This allows VMS specific file handling and some optimisations. It
  115.         should be noted that the primitives do not work with RISC/VMS until
  116.         someone has done some work on porting VAX.MAR.
  117.  
  118. There was also some preliminary work done on porting this to GNU C and indeed
  119. an earlier (developers) version ran under GNU C. The code affected is usually
  120. conditionalised with GCC. If someone wishes to complete this and (hopefully)
  121. integrate the inline assembler stuff used for moves and zero-fills, this
  122. would be very useful.
  123.  
  124. The MMS command procedure and VMSBUILD.COM build from sources in a directory
  125. pointed to by the logical SRC and objects pointed to by OBJ. This makes life
  126. a little easier as you can use a search list for the sources so you can keep
  127. the distribution intect.
  128.  
  129. All optimizations were checked out using DEC's PCA, and this version appears
  130. to be optimal under VAX C.
  131.  
  132. As for cleaning up, there are verious areas which could be improved:
  133.  
  134. 1)      PGP's own erase on delete could be replaced by the standard VMS
  135.         function so the file system does the work.
  136.  
  137. Contributing Authors
  138. --------------------
  139.  
  140. This port was originally performed by Hugh Kennedy with assistance from
  141. Mark Barsoum and others.
  142.  
  143. Support
  144. -------
  145.  
  146. This software is provided in the public domain and without charge other than
  147. for copying. For support issues concerning PGP and VAX/VMS, you are welcome
  148. to contact me via Electronic Mail on Compuserve using ID 70042,710 and on the
  149. Internet with 70042.710@compuserve.com. This software is provided "as-is" and
  150. any support given will be of an informal nature.
  151.  
  152. Hugh A.J. Kennedy, 11th February 1992
  153. Minor editing for 2.3 release, Colin Plumb, 14 June 1993
  154.